<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8"/>
    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
    <title>SqlMan/Docs Home</title>
    <meta name="description" content="TODO"/>
    <meta name="keywords" content="SqlMan, document, java sql, java jdbc, java orm, jdbc tools, jdbc helper, last one"/>
    <meta name="viewport" content="width=device-width, initial-scale=1"/>
    <meta
            name="viewport" content="width=device-width, initial-scale=1"/>
    <link rel="stylesheet" href="https://framework.ajaxjs.com/static/new-ui/css/common.css"/>
    <link rel="stylesheet" href="https://iam.ajaxjs.com/asset/main.css"/>
    <link rel="icon" type="image/png" href="/asset/favicon.png"/>
    <script src="https://framework.ajaxjs.com/static/aj-docs/common.js"></script>
    <script>
             var _hmt = _hmt || [];
             (function() {
               var hm = document.createElement("script");
               hm.src = "https://hm.baidu.com/hm.js?3cb62106ad945fc91efddfe250e1542e";
               var s = document.getElementsByTagName("script")[0];
               s.parentNode.insertBefore(hm, s);
             })();

    </script>
</head>
<body>
<nav>
    <div>
        <div class="links">
            <a href="/">🏠 首页</a>
            |
            ⚙️ 源码：
            <a target="_blank" href="https://github.com/lightweight-component/SqlMan">Github</a>/<a target="_blank" href="https://gitcode.com/lightweight-component/SqlMan">Gitcode</a>

            |
            <a href="/docs">English Version</a>
        </div>
        <h1>
            <img src="/asset/favicon-2x.png" style="vertical-align: middle;height: 45px;margin-bottom: 6px;"/> SqlMan
        </h1>
        <h3>轻量级 JDBC 助手——用户手册</h3>
    </div>
</nav>
<div>
    <menu>

        <ul>
            <li class="selected">
                <a href="/docs/cn">首页</a>
            </li>
            <li>
                <a href="/docs/quick-start-cn">快速开始</a>
            </li>
            <li>
                <a href="/docs/setup-cn">安装与配置</a>
            </li>
        </ul>
        <h3>数据库查询</h3>
        <ul>
            <li>
                <a href="/docs/query/query-concept-cn">基础概念</a>
            </li>
            <li>
                <a href="/docs/query/query-tutorial-cn">查询教程</a>
            </li>
            <li>
                <a href="/docs/query/query-paging-cn">分页查询</a>
            </li>
        </ul>
        <h3>写入数据</h3>
        <ul>
            <li>
                <a href="/docs/write/Create-Update-Delete-cn">创建/修改/删除</a>
            </li>
            <li>
                <a href="/docs/write/batch-cn">批量更新</a>
            </li>
        </ul>
        <h3>其他用法</h3>
        <ul>
            <li>
                <a href="/docs/other/sql-xml-cn">SQL 写在 XML 中</a>
            </li>
            <li>
                <a href="/docs/other/entity-cn">“类” ORM</a>
            </li>
        </ul>
        <h3>Misc</h3>
        <ul>
            <li><a href="/docs/common/versions-cn">更新历史</a></li>
            <li><a href="/docs/common/contact-cn">联系</a></li>
        </ul>
    </menu>
    <article class="aj-text chinese">
        <h1>欢迎来到 SqlMan 文档中心</h1>
        <p>这是一个用于关系型数据库（RDBMS）数据操作的 Java 辅助库，涵盖从底层 SQL 操作到高级低代码快速开发集成。首先，它封装了常见的 JDBC 操作，同时保留原始 SQL 语句输入（SQL 可以存储在 XML 或 Java 注解中）；其次，它为 Java
            实体提供便捷的 CRUD（创建、读取、更新、删除）操作，无需编写 SQL；最后，它提供了一个集成前两者特性的快速开发平台，只需提供 SQL 语句即可生成 API 接口，使用更加便捷。</p>
        <h3>使用 SqlMan 的一些优势：</h3>
        <ul>
            <li>熟悉的使用方式：
                <ul>
                    <li><code>sql().input('SELECT * FROM table WHERE id=?', 1).query()</code> -- 高度兼容 Spring JdbcTemplate/Apache DBUtils。</li>
                    <li>在 XML 中编写多行 SQL -- 高度兼容 MyBatis Mapper。</li>
                    <li><code>@Insert</code>、<code>@Update</code>、<code>@Delete</code>、<code>@Query</code> 注解 -- 高度兼容 JPA。</li>
                    <li>自动将 ResultSet 填充到 JavaBean 属性中。无需手动调用 setter 方法将列值复制到 bean 实例中。ResultSet 的每一行都可以由一个完全填充的 bean 实例表示。此外，Map 类型是可选的。</li>
                </ul>
            </li>
            <li>核心理念围绕 SQL。增强的 SQL 逻辑，支持动态 SQL（IF/ForEach）。</li>
            <li>内置常用的 CRUD/分页 功能，使简单系统可以实现 0% SQL 编写，在复杂项目中可节省 50% 的工作量。</li>
            <li>提供丰富的扩展功能，80% 的功能都可以自定义和扩展。</li>
        </ul>
        <h3>SqlMan 的设计理念：</h3>
        <ul>
            <li>小巧 - 近乎偏执的简单哲学。您应该能在短时间内理解整个包的内容。</li>
            <li>透明 - SqlMan 不会在后台进行任何魔法操作。您提供查询，它执行并为您清理。</li>
            <li>快速 - 您无需创建大量临时对象就能使用 SqlMan。</li>
        </ul>
        <h3>SqlMan 不是：</h3>
        <ul>
            <li>一个对象/关系映射桥接器 - 已经有很多优秀的 O/R 工具了。SqlMan 是为那些想要使用 JDBC 但不想处理繁琐细节的开发者设计的。</li>
            <li>不提供函数式链式调用，因为作者认为这样的可读性较差且调试不便。</li>
            <li>任何形式的重量级框架 - 这里的目标是成为一个直接且易用的 JDBC 辅助库。</li>
        </ul>
        <h2>源代码</h2>
        <p>基于 GNU GENERAL PUBLIC LICENSE v3.0 许可。</p>
        <ul>
            <li>Github：<a href="https://github.com/lightweight-component/SqlMan">https://github.com/lightweight-component/SqlMan</a></li>
            <li>Gitcode：<a href="https://gitcode.com/lightweight-component/SqlMan">https://gitcode.com/lightweight-component/SqlMan</a>，供中国用户更快访问。</li>
        </ul>
        <h2>链接</h2>
        <p><a href="https://sqlman.ajaxjs.com">网站</a> | <a href="https://sqlman.ajaxjs.com/docs">文档</a> | <a href="https://github.com/lightweight-component/SqlMan">JavaDoc</a></p>

    </article>

</div>
<footer>
    SqlMan, a part of <a href="https://framework.ajaxjs.com" target="_blank">AJ-Framework</a> open source. Mail:
    frank@ajaxjs.com, visit <a href="https://blog.csdn.net/zhangxin09" target="_blank">my blog(In Chinese)</a>.
    <br/>
    <br/>
    Copyright © 2025 Frank Cheung. All rights reserved.
    <script>
        var _hmt = _hmt || [];
        (function() {
          var hm = document.createElement("script");
          hm.src = "https://hm.baidu.com/hm.js?3cb62106ad945fc91efddfe250e1542e";
          var s = document.getElementsByTagName("script")[0];
          s.parentNode.insertBefore(hm, s);
        })();

    </script>
</footer>
</body>
</html>